home *** CD-ROM | disk | FTP | other *** search
/ Aminet 31 / Aminet 31 (1999)(Schatztruhe)[!][Jun 1999].iso / Aminet / dev / cross / z88dk_v1.0s.lha / zcc.readme < prev   
Encoding:
Text File  |  1999-03-23  |  4.6 KB  |  119 lines
  1. Short:    Z88DK - Generic Z80 Small C+ Compiler with Z88 Libraries
  2. Author:   Cain, Yorston et al, extended by Dominic Morris
  3. Uploader: Dominic Morris <djm@jb.man.ac.uk>
  4. Type:     dev/cross
  5.  
  6. Z88DK v1.0 - sccz80 v1.10b0.51
  7. ------------------------------
  8.  
  9. Z88DK is a package along the lines of the GBDK, however it produces code
  10. for full Z80s and not the cutdown version in the Gameboy.
  11.  
  12. The package consists of a Small C+ Compiler, Peephole Optimizer, and
  13. unified assembler and linker (provided by Z80asm from Interlogic).
  14. Libraries are supplied for the Cambridge Z88 however it would be a fairly
  15. trivial task to create libraries for other Z80 based machines.
  16.  
  17. This is the first public release of the compiler, however it has under
  18. fairly extensive testing for 6 months and I now believe it to produce
  19. stable code.
  20.  
  21. Features of the compiler include:
  22.  
  23. - Structs/unions
  24. - Floating point support (either generic Z80 or stubs for the Z88 fp
  25.   calculator)
  26. - Long (32 bits), int (16 bits), char (8 bits) datatypes
  27. - Signed and unsigned datatypes
  28. - Compiler support for far datatypes (allows support for up to 4MB of
  29.   memory) though no library support as yet.
  30. - Literal pools for double constants and strings, both pools feature
  31.   literal merging (removal of repeated constants).
  32. - ANSI & K&R function style declarations and prototypes
  33. - Extensive support library (over 200 usable routines) including almost a
  34.   full complement of string and ctype functions
  35. - Definition during declaration of global and local static variables
  36.   (though not auto variables)
  37.  
  38. The compiler front end (zcc) is a much rewritten affair based on the 
  39. ZCC096 frontend by Ken Yap, it has been considerably extended and rewritten
  40. to function as much as possible like any other big box compiler frontend.
  41.  
  42. Optimization is provided courtesy of a peephole optimizer which substitutes
  43. certain compiler output for more efficient code, in particular logical
  44. operation on unsigned chars are well catered for. Savings in program size
  45. of over 10% are common place.
  46.  
  47. All assembler output is generated in a form suitable for use with the
  48. Z80 Module Assembler from Interlogic (A full setup is included within
  49. this archive), this freely distributable assembler generates compact
  50. object files and allows linking in of routines from multiple library files.
  51.  
  52. The source code for the entire suite is available in a separate archive
  53. (z88dk_v1.0s.lha).
  54.  
  55. Potential Problems:
  56.  
  57. - Floating point constants may not be correctly evaluated, I can't
  58.   reproduce the problem that has been reported by some people.
  59. - Far Pointer code is far from complete so the compiler might produce
  60.   some spectacularly duff code.
  61.  
  62. Potential source of confusion:
  63.  
  64. - This compiler comes with no warrantry, if it works for you, thats great,
  65.   if it doesn't and in the process destroys France than thats not my
  66.   problem!
  67.  
  68. The compiler lacks the following features:
  69.  
  70. - Casts (though conversions between types are done automatically this will
  71.   raise compiler warnings)
  72. - Enums (get around by use #define)
  73. - Typedefs (get around by use of #define)
  74.  
  75. Recompense:
  76.  
  77. - This compiler suite is provided free of charge and nothing is expected
  78.   off of you if you use it, however it would be nice to get an email if
  79.   you use it. If you release a commercial program using this package then
  80.   it would be good to learn about it and know that all my work is not in
  81.   vain! (A copy of the program would be appreciated). 
  82.  
  83. - Hardware, especially of the SCSI variety, always accepted <grin>
  84.  
  85. A few thank yous:
  86.  
  87. Although I mention them in the doc file, I feel I ought to mention the
  88. following people, without whom this compiler would not have got this far:
  89.  
  90. - Dennis Groning, this guy tirelessly compiled the compiler for WinBlows
  91.   and reported back with so many bug reports and suggestions that have
  92.   made the compiler so much better.
  93.  
  94. - Gunther Strube, without this guys assembler, z80asm, I wouldn't be sat
  95.   here writing this text.
  96.  
  97. - Garry Lancaster, for not compiling for Linux for almost 6 months(!), but
  98.   especially for putting up with me rabbiting on about it for those 6
  99.   months without getting too irate (though he did write convert Forth for
  100.   the Z88 in that time - maybe thats his way of venting anger?!?! <grin>)
  101.  
  102. Finally:
  103.  
  104. I'm still developing the Compiler, and I would very much like to keep
  105. a unified Cross Compiler, I release the source so that you can pick up
  106. on any bugs, laugh at the kludges which I've made(!) If you make any
  107. changes could you please let me know so that I can incorporate them into
  108. my set of sources - it would be a shame to come this far and end up with
  109. n different distributions, cheers!
  110.  
  111. Have fun with the package,
  112.  
  113. d.
  114. <djm@jb.man.ac.uk>
  115.  
  116. 22/3/99
  117.  
  118.  
  119.